home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 001 / whereis / readme < prev    next >
Text File  |  1993-08-25  |  5KB  |  100 lines
  1. 25 August 1993.
  2. Archimedes whereis 1.20 (C)1993 Kai Schlichting (kai@phantom.com)
  3. Usage: whereis [-vfh?] <name>|<- -name> 
  4. Displays all matches for <name> in the order of execution when given
  5. as *command in shell:
  6. 1) CLI *commands that match <name> exactly ,including the adjacent module name.
  7. 2) Alias$<name> definitions that match <name> exactly are returned. 
  8. 3) filenames in the Run$Path which's leafname matches <name> exactly 
  9.  <name> can also be <name*>, here, then all leafnames which match *name*
  10.  are returned.
  11.  If <name> begins with a '-' a '-' must be the argument before
  12.  <name> (e.g. 'whereis - -v' to search for file '-v').
  13.  If no name is given, the -v switch will report the number of
  14.  *commands/files alone. (-f switch is valid,then)
  15.  The case of -v -f or -h does not matter.
  16. -v switch: be verbose when searching and report number of *commands and files.
  17. -f switch: search File$Path,too,in addition to Run$Path.
  18. -h or -? switch: Display this help screen.
  19.  
  20. This is whereis/which for the Arc, a unix-like whereis with added 'which'
  21. funcionality ,and it's designed to reside in your library (which most
  22. harddisk,but few floppy users have).
  23.  
  24. What it will do: search thru all entries in your Run$Path system variable,
  25.                  and turn up the matching files/directories within the path.
  26.                  (these matches apply to the leafname,only!
  27.                  e.g. ($.prog.lib.c.test  : leaf is test)
  28.                  it will search recursively into an expression such like
  29.                  C:,Lib: in the Run$path.
  30.  
  31.                  Since version 1.20, it will also show aliases of the
  32.                  Alias$<command> type,as well as CLI *commands residing in any
  33.                  module on the system, and will show the name of the module,too.
  34.                  If the -f switch is given,it will search through the File$Path,
  35.                  albeit these files would not be executed when given as
  36.                  commands.
  37.                  If -v is given but no <name> ,the directories are counted
  38.                  through for the number of modules/files/dirs, as normally
  39.                  with -v.
  40.                  File starting with a '-' must be preceded with a '-' prior the
  41.                  name,f.ex. : *whereis - -emacs   will search for '-emacs'.
  42.                  Flexible argument/switch handling has been added: switches
  43.                  can be given all at once : whereis -fv <name>  or separated:
  44.                  whereis -f <name> -v . A switch given twice does not produce
  45.                  an error.
  46.  
  47.  
  48.  
  49. Purpose: I always execute commands on commandline,but tend to forget where
  50.          they reside. This program finds where. It also gives
  51.  
  52. The -v (verbose) switch will display the individual directories of Run$Path
  53. while searching. Note the -v option can be given AFTER the filename,too.
  54.  
  55. The source is provided, for recompiling you'll need unixlib 3.6c (by Huw
  56. Rogers) , as well the patch for strstr(),see file 'UnixLfix' .
  57.  
  58. This program is distributed under the GNU public license,read: the
  59. NO WARRANTIES terms do apply.
  60.  
  61. Limitation: the source and the program might not be distributed bundled
  62. with commercial software,which I define as software distributed under
  63. conditions that don't include the GNU public license.
  64.  
  65. Limitation 2: contrary to the GNU public license,deriving sources of this
  66. program,or it's binaries or binaries of deriving sources must NOT be sold for
  67. commercial gain. (this to prevent certain 'software houses' who sell
  68. ready-to-run Emacs/GCC/other GNU wareZ binaries for muchos $$$$ ,
  69. from doing so with this program).
  70. -----------------
  71. *NEW NEW NEW NEW*
  72. -----------------
  73. This specifically means (version 1.20 and up):
  74. a PD 'vendor' must not charge more than 80 US cents per 800k disk,!INCLUDING
  75. MEDIA ! that contains this program. (I pay 40c for a 800k brand disk here)
  76. If you can't break even with this: too bad,you rip of the users,and you better
  77. trash this program NOW!!! This is especially true for the
  78. German Acorn Distributor GMA , (shall I mention Jona Gebauer handing out
  79. |>aV1DP1ll1|\|G-WaReZ a while ago in total ignorance/unawareness of what she was
  80. handing out ?).
  81. -----------------
  82.  
  83. I can be contacted (at time of writing):
  84. kai@phantom.com (Kai Schlichting)
  85. acorn@info2.rus.uni-stuttgart.de (Acorn ftp admin, ftp to this server and get
  86. (finger this account for latest info!)        things here FAST and FIRST !!!)
  87. j08i@alf.zfn.uni-bremen.de (running out,last reserve)
  88. [sarcastic mode on]
  89. Snail mail users need not apply.
  90. [sarcastic mode off]
  91.  
  92. Music heard while developing: DC 101.1 ,the greatest station in D.C.
  93. ZZ Top : high and low
  94. AC/DC  : Money Talks
  95. Aerosmith : Eat the rich
  96. Front 242 : ugh, just kidding ,that's virus writer music (:-)
  97.  
  98. Credits: A Oliver at Acorn UK for his bugreports and acting cool.
  99. -EOF-
  100.